home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds / sysstat.man < prev    next >
Text File  |  1992-05-22  |  3KB  |  69 lines
  1. ' $Header: /sprite/src/cmds/sysstat/RCS/sysstat.man,v 1.4 92/05/22 18:35:55 kupfer Exp $ SPRITE (Berkeley)
  2. .so \*(]ltmac.sprite
  3. .HS SYSSTAT cmds
  4. .BS
  5. .SH NAME
  6. sysstat \- print statistics and information about the state of the system
  7. .SH SYNOPSIS
  8. \fBsysstat \fR[\fB\-vcR\fR]
  9. .SH OPTIONS
  10. .IP "\fB\-v\fR" 14
  11. Print out the compilation version timestamp for the kernel.  This is
  12. the default if no options are specified. 
  13. .IP "\fB\-c\fR" 14
  14. Print out the number of times each system call has been invoked.
  15. .IP "\fB\-p\fR \fIn\fR" 14
  16. Enable or disable system call timing.
  17. .IP "\fB\-t\fR" 14
  18. For each system call, print the number of calls and how much time was
  19. required. 
  20. .IP "\fB\-R\fR" 14
  21. Reset the count and time information for system calls.
  22. .BE
  23.  
  24. .SH DESCRIPTION
  25. .LP
  26. This command prints out statistics and other information about the
  27. system.   
  28. .SH "VERSION TIMESTAMP"
  29. .IP "\fB\-v\fR"
  30. By default, \fBsysstat\fR prints the compilation version timestamp for the
  31. kernel.  This is a unique identifier indicating who compiled the
  32. kernel and when.  This information is printed if no options are
  33. specified, or if the \fI-v\fR  option is specified.  
  34. .SH "SYSTEM CALL STATISTICS"
  35. .IP "\fB\-c\fR"
  36. This option indicates that \fBsysstat\fR should display a count of the
  37. number of times each system call has been invoked.  For each call, the
  38. number of invocations is printed along with an indication of whether
  39. the call, if done by a migrated process, would be handled locally or
  40. would require action by the process's \fIhome node\fR.
  41. .IP "\fB\-t\fR"
  42. This option tells 
  43. .B sysstat
  44. to display for each system call the number of times the call was
  45. invoked, the total time spent in that call, and the average time spent
  46. in that call.  Note that if a process is migrated, its system calls
  47. are recorded by the host that it is executing on, rather than by the
  48. home node.  Normally system call timing is turned off; use the
  49. .B \-p 
  50. option to turn it on.
  51. .IP "\fB\-R\fR"
  52. This option causes \fBsysstat\fR reset the kernel's count of the
  53. number of times each system call has been invoked, as well as the
  54. accumulated time for each system call.  Thus, subsequent invocations of
  55. \fBsysstat\fR with the \fB\-c\fR or \fB\-t\fR option will report only
  56. activity since the invocation with the \fB-R\fR option.
  57. .IP "\fB\-p\fR"
  58. This option controls whether Sprite keeps track of how much time each
  59. system call takes.  To turn on system call timing, use 
  60. .BR "\-p 1" ;
  61. to turn it off, use
  62. .BR "\-p 0" .
  63. .SH BUGS
  64. System call timing is only available on ds5000s.
  65. .SH "SEE ALSO"
  66. migcmd, fscmd
  67. .SH KEYWORDS
  68. statistics, process migration, system call
  69.